---
title: Markdown 语法指南
description: 本文介绍了 Markdown 语法的基本用法，并提供了一些示例。
date: "2021-09-09"
lang: zh
tags:
  - 博客
  - 软件
  - 工具
category: 技术
cover: https://cdn.qladgk.com/images/20250508162937860.png
---

import Image from "@/components/mdx/Image";

<Image
  src="https://cdn.qladgk.com/images/20250508162937860.png"
  alt="cover"
  width={999}
  height={527}
  isArticleImage={true}
/>

Markdown 是一种轻量级标记语言，旨在使文本的格式化更加简洁直观。以下是一些常用的 Markdown 语法及其示例。

## 1. 标题

Markdown 支持六级标题。使用 `#` 符号表示标题的级别，`#` 的数量表示标题的级别。

```markdown
# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题
```

---

## 2. 段落和换行

段落通过一个或多个空行分隔。要在段落中插入换行符，可以在行尾添加两个或更多空格。

```markdown
这是一个段落。

这是另一个段落，
在这里插入换行符。
```

这是一个段落。

这是另一个段落，
在这里插入换行符。

---

## 3. 粗体和斜体

- **粗体**：使用 `**` 或 `__` 包围文本。
- **斜体**：使用 `*` 或 `_` 包围文本。

```markdown
**这是粗体文本**

**这也是粗体文本**

_这是斜体文本_

_这也是斜体文本_
```

**这是粗体文本**

**这也是粗体文本**

_这是斜体文本_

_这也是斜体文本_

---

## 4. 列表

Markdown 支持无序列表和有序列表。

- **无序列表**：使用 `*`、`+` 或 `-`。
- **有序列表**：使用数字和点。

```markdown
无序列表：

- 项目 1
  - 子项目 1
  - 子项目 2

有序列表：

1. 第一项
   1. 子项 1
   2. 子项 2
```

无序列表：

- 项目 1
  - 子项目 1
  - 子项目 2

有序列表：

1. 第一项
   1. 子项 1
   2. 子项 2

---

## 5. 链接

插入链接使用 `[文本](URL)` 语法。

```markdown
[OpenAI](https://www.openai.com/)
```

[OpenAI](https://www.openai.com/)

---

## 6. 图片

插入图片使用 `![替代文本](图片 URL)` 语法。

```markdown
![Markdown Logo](https://markdown-here.com/img/icon256.png)
```

## ![Markdown Logo](https://markdown-here.com/img/icon256.png)

---

## 7. 引用

引用使用 `>` 符号。

```markdown
> 这是一个引用
```

> 这是一个引用

---

## 8. 代码

- **行内代码**：使用反引号 `` ` `` 包围代码。
- **代码块**：使用三个反引号 ` ``` ` 或者缩进四个空格。

````markdown
行内代码：`console.log('Hello, World!')`

代码块：
\```
function greet() {
console.log('Hello, World!');
}
\```
````

行内代码：`console.log('Hello, World!')`

代码块：

```js
function greet() {
  console.log("Hello, World!");
}
```

---

## 9. 表格

表格使用 `|` 符号分隔列，`-` 符号分隔表头和表体。

```markdown
| 列 1   | 列 2   |
| ------ | ------ |
| 数据 1 | 数据 2 |
| 数据 3 | 数据 4 |
```

| 列 1   | 列 2   |
| ------ | ------ |
| 数据 1 | 数据 2 |
| 数据 3 | 数据 4 |

---

## 10. 分隔线

分隔线使用三个或更多的 `-`、`*` 或 `_`。

```markdown
---
---

---
```

---

---

---
